import "@site/src/languages/highlight";

# App的全局事件

**描述：**

&emsp;&emsp;全局事件的定义。
这只是一个事件定义的展示，包含所有全局事件名称和回调函数的定义。

**用法示例：**
```tl
-- 可以使用如下示例代码注册这些事件：
local node = Node():addTo(Director.entry)
node:gslot("AppEvent", function(eventType: string)
	print("接收到系统事件：" .. eventType)
end)
```

## AppEvent

**类型：** 全局事件。

**描述：**

&emsp;&emsp;应用收到系统事件时触发。事件类型可以是 "Quit"、"LowMemory"、"WillEnterBackground"、"DidEnterBackground"、"WillEnterForeground"、"DidEnterForeground"。

**签名：**
```tl
["AppEvent"]: function(eventType: string)
```

## AppChange

**类型：** 全局事件。

**描述：**

&emsp;&emsp;应用设置发生变化时触发。设置名称可以是 "Locale"、"Theme"、"FullScreen"、"Position"、"Size"。

**签名：**
```tl
["AppChange"]: function(settingName: string)
```

## AppWS

**类型：** 全局事件。

**描述：**

&emsp;&emsp;当一个客户端和应用建立 Websocket 连接时并收发到事件时触发。事件类型可以是 "Open"、"Close"、"Send"、"Receive"。

**签名：**
```tl
["AppWS"]: function(eventType: string, msg: string)
```